home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (4th Edition) / The Business Master - 4th Edition.iso / files / grapties / multimed / install.exe / lha / RUNTIME.DOC < prev    next >
Text File  |  1993-10-08  |  13KB  |  264 lines
  1.  
  2.  
  3.  
  4.                              THE RUN-TIME PROGRAM
  5.  
  6.              There is a run-time  program  included  in  this  kit  to
  7.          display  multimedia  pictures  created  with  The  Multimedia
  8.          Workshop.  In most cases, you will want to  include  it  with
  9.          your  pictures  on disks that you distribute, so that the end
  10.          users will be  able  to  use  your  pictures.  This  run-time
  11.          program,   called   MSHOW.EXE,   is   yours   to   distribute
  12.          royalty-free, as many copies as you like.
  13.  
  14.              MSHOW   runs   in   either  of  two  modes,  "batch"  or
  15.          "presentation" mode.  In batch mode, it displays one picture
  16.          complete with sound effects, etc, then waits for the user to
  17.          press  any  key  before  returning  control  to   DOS.    In
  18.          presentation mode, it displays a series of picture files and
  19.          presents  the  end  user  with  a  menu  from which the user
  20.          controls the presentation.
  21.              When MSHOW starts, it  looks  to  see  if  there  is  an
  22.          accompanying  picture  file  name typed at the DOS prompt or
  23.          provided in the batch file from which you  may  have  called
  24.          MSHOW.   If  found,  MSHOW  displays that picture file, then
  25.          returns to DOS.
  26.              If  there  is  no  picture  file  listed with the call to
  27.          MSHOW, it looks for a special file on disk called  MSHOW.CFG,
  28.          which  is created with the BUILD option on the The Multimedia
  29.          Workshop file menu.  If it finds MSHOW.CFG then  it  runs  in
  30.          presentation mode, using the group of picture files listed in
  31.          the MSHOW.CFG file.  If you list a different file with a .CFG
  32.          extension  on  the command line or within a batch file, MSHOW
  33.          will look in that file for a list of the scripts  to  display
  34.          in presentation mode.
  35.              In  presentation  mode, a small menu appears allowing the
  36.          user to take one of several actions.  They are:
  37.  
  38.              HELP
  39.              BACK
  40.              NEXT
  41.              MOVE
  42.              RES
  43.              AUTO
  44.              MORE
  45.              FIND
  46.              QUIT
  47.  
  48.              These options can be selected with the mouse, arrow  keys
  49.          or  number keys (with [Num Lock] on for faster movement) then
  50.          a press of the [Enter] key, or a click of  the  left  button.
  51.          You can also press the first letter of any menu item.
  52.  
  53.          HELP  displays  a  single screen of information about how to
  54.          use the menu (although quite unnecessary!)
  55.  
  56.          BACK shows the previous picture viewed.
  57.  
  58.          NEXT shows the next picture in your presentation,
  59.  
  60.          MOVE  moves  the menu to another location so that it does not
  61.          obscure the picture.
  62.  
  63.          RES (Resume) displays the last  picture  viewed  during  the
  64.          last  time  MSHOW was used.  It does this by writing a small
  65.          file to disk containing the number of the picture  currently
  66.          displayed  when  the user quits the MSHOW program.  The next
  67.          time the program is started, if the user selects RESUME,  it
  68.          reads  that  file  and  finds  the  picture  so the user can
  69.          continue from where he left off.
  70.  
  71.          AUTOmate is to display your presentation over and over again
  72.          automatically.  When selected, MSHOW  asks  you  to  type  a
  73.          number  of seconds. It will pause for that long between each
  74.          picture.   When  it  comes  to  the  last  picture  in  your
  75.          presentation,  it  will  start  all  over  again.   This  is
  76.          excellent for trade  show  displays,  retailers  can  put  a
  77.          monitor  in  their  store windows at night advertising their
  78.          products, computer retailers  can  leave  MSHOW  running  on
  79.          computers  in  their stores. A student at a science fair can
  80.          create a show about her project and display it at her table.
  81.  
  82.          MORE contains two choices:
  83.  
  84.          GOTO is an electronic Table of Contents. When selected,  the
  85.          end user is presented with a picture of a Table of Contents,
  86.          and  can  type  a  number, and then be taken to that picture
  87.          within your presentation.  This  is  optional  and  requires
  88.          that  you make a special picture called GOTO.  If MSHOW does
  89.          not find a GOTO file, it merely  ignores  the  GOTO  request
  90.          without  harm.  Making a GOTO picture is easy, and I'll tell
  91.          you all about it in a couple of minutes.
  92.  
  93.          REPLAY simply replays  the  current  script  file  from  the
  94.          beginning.
  95.  
  96.          FIND  allows  the  end user to type a word or phrase.  Then,
  97.          starting at the beginning of your presentation  and  working
  98.          to  the  end,  MSHOW  quickly searches each picture file for
  99.          that word or phrase. If found, the picture is  displayed  on
  100.          the screen and a small menu appears to allow the end user to
  101.          continue  searching  for  more occurrences, or return to the
  102.          regular menu.  In addition  to  selecting  SEARCH  with  the
  103.          mouse  or menu bar, the user can press [S] or [F] to begin a
  104.          search.  As you might expect, it works rather slowly when  a
  105.          big presentation is on a floppy disk.
  106.  
  107.                                      QUIT
  108.  
  109.          This is the way out to DOS.
  110.  
  111.          NOTE: All runtime programs used by your presentation must be
  112.          copied onto your final disk.  If you use synthesized speech,
  113.          PC-TALK.EXE  and  the speech files must be copied along with
  114.          your script files.
  115.             Also, if  you  use  any  fonts  except  DEFAULT  then  the
  116.          corresponding  .MMF  files  must be copied onto your finished
  117.          disk.  If you use Live Text, the  corresponding  ASCII  files
  118.          must  also  be  available.  If  you  use .PCX or .GIF images,
  119.          these, too must be on the end users' disks.
  120.  
  121.                               MAKING A GOTO FILE
  122.  
  123.          This is optional.  The GOTO file is a special  picture  file
  124.          which  is  used  by  GOTO as a 'live table of contents.' The
  125.          user can type a number corresponding to any of the  pictures
  126.          in your presentation, and be taken to that picture.
  127.              First  complete all the pictures in your presentation and
  128.          use TMW's BUILD option to make an MSHOW.CFG file. Make a note
  129.          of the numbers to the left of the picture files that will  be
  130.          key points in your presentation.
  131.  
  132.              To  make  the  GOTO  file,  start  a  new picture file by
  133.          selecting CHOOSE FILE from the FILE menu and call it GOTO. No
  134.          other name will do, and it cannot  have  any  extension.   In
  135.          this  file,  list  or  illustrate  the  key  pictures in your
  136.          presentation and put a number next to them. These numbers are
  137.          the number of the script file's position in  the  menu.   The
  138.          first  script  file is 1, and the second is 2, etc.  In other
  139.          words, if you have created a catalog of  blacksmith's  tools,
  140.          and you have several pictures of anvils, you need to know the
  141.          position  of the first picture file of an anvil in your anvil
  142.          section. This will be one of your goto points.  You can  have
  143.          as many goto points as you can fit onto the GOTO picture.
  144.  
  145.              When  your  GOTO  picture is done, include it along with
  146.          your other picture  files,  MSHOW.CFG  and  MSHOW.EXE  in  a
  147.          sub-directory  or  on a disk, then test it by running MSHOW,
  148.          selecting GOTO, and  typing  the  numbers  for  the  various
  149.          points,  and  make sure the pictures you expected come up as
  150.          you planned.
  151.  
  152.                             COMPLEX PRESENTATIONS
  153.  
  154.              You can now put 2, 3, 4 or actually an unlimited  number
  155.          of independent presentations on a single disk.
  156.  
  157.          Normally,  MSHOW.EXE  looks for a file called MSHOW.CFG, and
  158.          if it finds it, a presentation  begins.   However,  you  can
  159.          create  more  than one MSHOW.CFG file, and rename the second
  160.          one.  It can have any DOS-legal filename,  as  long  as  the
  161.          extension  is  .CFG.  Then, when starting MSHOW.EXE, whether
  162.          from the command line, or from a batch file,  if  you  don't
  163.          want  it to use MSHOW.CFG, but rather a different .CFG file,
  164.          specify it as the first parameter after you type MSHOW.
  165.  
  166.          Furthermore, you might want to use separate GOTO  files  for
  167.          each  presentation.  Therefore, if you specify a script file
  168.          name as a  second  parameter,  that  will  become  the  GOTO
  169.          picture.
  170.  
  171.          Here is an example:
  172.  
  173.          MSHOW FIRST.CFG GOTO1
  174.          MSHOW SECOND.CFG GOTO2
  175.          MSHOW THIRD.CFG GOTO3
  176.  
  177.          A  batch file containing these lines will run three separate
  178.          shows, all running from their own  selections  of  files  as
  179.          specified first by FIRST.CFG, then by SECOND.CFG and finally
  180.          by  THIRD.CFG.   Each  presentation  will have it's own GOTO
  181.          picture.
  182.  
  183.          NOTE: If you use GOTO files at all,  you  should  specify  a
  184.          goto file by name as a second parameter for each instance of
  185.          MSHOW.EXE.  Otherwise, if there is a file named "GOTO," that
  186.          one  will  be  used for each presentation, whether or not it
  187.          would correspond to the correct show.
  188.  
  189.  
  190.                               RENAMING MSHOW.EXE
  191.  
  192.          Using the DOS command REN (Rename) you can change  MSHOW.EXE
  193.          to  BEGIN.EXE or GO.EXE, or you can make a batch file called
  194.          GO.BAT or START.BAT (etc) that starts MSHOW.  This makes  it
  195.          easier for the end user to start your presentation.
  196.  
  197.                            USING MSHOW IN BATCH MODE
  198.  
  199.          Batch  mode  is for displaying a single script file from the
  200.          command line, or for use within  batch  files.   MSHOW  will
  201.          simply  show  a  picture,  along  with  it's  sound effects,
  202.          hyper-links or animation, then wait for the  user  to  press
  203.          any key.  When a key is pressed, control is returned to DOS.
  204.  
  205.          Using  Batch  mode  to  display  a single picture which is a
  206.          hyper-linked  menu  to  all  other  pictures  or  series  of
  207.          pictures  in your presentation is a very clean way to make a
  208.          presentation which can entirely eliminate the top menu bar.
  209.  
  210.          To use batch mode from the DOS prompt, type MSHOW, a  space,
  211.          then  the name of the picture file that you want to display.
  212.          For example:
  213.  
  214.             MSHOW C:\PICTURES\SPIDER.3
  215.  
  216.          or
  217.  
  218.             MSHOW SPIDER.4
  219.  
  220.          if your picture file is in the same place as MSHOW.EXE.
  221.  
  222.          If you have a few pictures you want to display, and you want
  223.          to use a batch file to line them up, you  can  do  something
  224.          like this:
  225.  
  226.          Make a batch file called BEGIN.BAT, and in it, include these
  227.          lines:
  228.  
  229.          MSHOW SPIDER.1
  230.          MSHOW SPIDER.2
  231.          MSHOW SPIDER.3
  232.          MSHOW SPIDER.4
  233.  
  234.          When  this  batch  file is run (when the user types BEGIN) a
  235.          picture of a  spider,  your  picture  called  SPIDER.1  will
  236.          appear.   When the user is through studying the first spider
  237.          and presses any key, your next spider picture, SPIDER.2,  is
  238.          shown, and so on until all four pictures have been shown.
  239.  
  240.          And  of  course you can also use the batch file to run other
  241.          programs, for instance:
  242.  
  243.          MSHOW MY_INTRO.PIC
  244.          MYPROG.EXE
  245.          MSHOW END.PIC
  246.  
  247.              Hyper-links work  from  batch  mode  the  same  as  from
  248.          presentation mode.
  249.              The  more  you  learn about batch files, the more things
  250.          you can do in the  way  of  mixing  and  matching  programs,
  251.          picture  files, more programs, etc.  For instance, you could
  252.          make a catalog disk which is mostly  text,  but  in  between
  253.          displaying price lists with a text presentation program, you
  254.          could  display  pictures of your more popular or interesting
  255.          products.
  256.  
  257.          NOTE:  If  you have used any fonts except DEFAULT within TMW,
  258.          their corresponding disk file(s), *.MMF, must be copied  onto
  259.          your presentation disks along with your picture files.
  260.  
  261.          _____________________________________________________________
  262.                                                        end of chapter.
  263.  
  264.